home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
PD Collection CD 1
/
PD Collection CD 1.iso
/
textual
/
txt2strg
/
ReadMe
next >
Wrap
Text File
|
1995-07-02
|
2KB
|
69 lines
Texi2Strong v1.00
~~~~~~~~~~~~~~~~~
texi2strong v1.0 - © 1995 Jochen Scharrlach (jscharrl@ba-stuttgart.de)
This program is freeware, i.e. you can freely use and distribute it.
You may not sell this program or distribute modified versions without
having the permission from the author.
Usage: perl texi2strng <texinfo-file> <directory>
What is Texinfo?
----------------
Texinfo is a documentation system used by many GNU programs like GCC,
Bison, Flex. You can either generate a hypertext documentation (INFO)
or a printed manual via the TeX-DVI format.
General comments
----------------
This script is simply one big hack, there are several features missing
but I was able to convert several Texinfo manuals I was interested in
and for me that's all what counts. Don't look too critical at the
formatting - !StrongHlp does less formatting than TeXinfo, so it would
be a major job to do this nicely.
If you don't know Perl5, don't try to understand the script...
To use it under RiscOS
----------------------
you'll need:
- Perl5 release 1.5 or later (currently, there is only release
1.0 officially available)
- an archive filing system like !ArcFS of !SparkFS, beacause the script
generates usually more than 77 files and you can't feed !StrongHlp
with those files directly (at least it didn't work with StrongHlp v2.02)
Before you start, make sure that the variable $RiscOS is "1" (it is set at
the top of the script).
To use it under Unix
--------------------
you'll need:
- Perl 5
Set $RiscOS to "0".
If you have major trouble
-------------------------
If you get warnings , take a look at the result before you send me a bug
report: some "bugs" have no effect!
If you find major bugs, drop me a mail with a description and an example:
jscharrl@ba-stuttgart.de
Special thanks to:
------------------
* Larry Wall & friends for writing Perl
* Luke Taylor & Paul Moore for porting it to RiscOS
* Guttorm Vik for writing a *free* documentation system for RiscOS
Enjoy!
02/07/95 Jochen Scharrlach